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1 A METHOD FOR GENERATING LOCALIZABLE MESSAGE 

2 CATALOGS FOR JAVA-BASED APPLICATIONS 

3 
4 

5 FIELD OF THE INVENTION 

6 The present invention relates generally to windows-based computer 

7 applications, and more particularly to localizable message catalogs for Java- 

8 based applications. 

9 

io BACKGROUND OF THE INVENTION 

Hiii The increasing use of the Internet and other distributed networks for a 

Mi2 variety of purposes, including international commercial, scientific and cultural 

H13 discourse, makes the ability to readily and reliably produce and support global 

f : : ;: r 

" |E i4 software increasingly important. Global software, or applications, refers to 

~~i5 software that is developed independently of specific languages or geographic 

]:j6 regions and capable of being translated into any desired language or region of 

y:ji7 an end user at run-time. 

18 

19 The internationalization process implies that the software consists of a 

20 single set of binaries that operates under all languages, and that the language- 

21 sensitive areas in the source code, referred to as the "localizable areas", such 

22 as end-user visible strings, data and numeric formats, are stored in external 

23 files. The C/C++ programming language, for instance, uses this 

24 internationalization model by storing the language-sensitive areas in external 

25 files called "message catalogs". Message catalogs are based on the standard 
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1 defined by the X/Open Portability Guide (XPG) and are thus very attractive for 

2 localization. These message catalogs are not source code but are text files, 

3 designed for localizability, that allow easy translation of texts into native 

4 languages, such as French, Italian, Russian, German or Japanese. The 

5 C/C++ programming language "loads" the appropriate language versions of 

6 these message catalogs based on the end-user's language at run-time. When 

7 a user starts up an internationalized application, the application first checks to 

8 see which locale is in use by the user. For instance, when a user runs an 
r , 9 application on a German NT server, the user is using the German locale. The 
jjio locale in use by the user, determined at run-time, will be used by the 
njii application for the display text and other user interface elements. If the user 
j;;ji2 changes the locale in use, such as by restarting the desktop environment 
f jL3 under another locale, the application will use that other locale to display the 
Su texts and other user interface elements. 

16 This internationalization approach is not available for software written in 

17 the portable Java programming language by Sun Microsystems because the 
is Java programming language does not store language-sensitive areas in the 

19 source code in message catalogs. The Java programming language provides 

20 a framework for developing global applications which allows for translation of 

21 end-user visible strings, referred to as "display strings" or "localizable strings," 

22 that may be shown to an intended user and therefore need to be translated for 

23 different countries. A Java global application is comprised of a collection of 
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1 related Java source code files, hereafter referred to as a "package". Each of 

2 the Java source files contained in a package may contain display strings. To 

3 produce global software, these display strings need to be translated to 

4 different countries or languages of the intended users. This translation 

5 includes translation of messages, numbers, dates, and currency into a 

6 country's conventional formats. Non-display strings, such as comments and 

7 Universal Resource Locators (URLs), are used programmatically and are thus 

8 not translated. 

9 

*J3io As mentioned, the Java programming language does not store display 

J;;^ i strings in message catalogs but instead stores language-sensitive areas in a 

Q2 source code data structure referred to as a "ListResourceBundle". Basically, 

S....J: 

g 13 a ListResourceBundle data structure provides a way to access display strings 

Di4 according to locale conventions. The ListResourceBundle data structure has a 

445 unique identifier to a display string, referred to as a "display string key", that 
enables "display string value" mapping. A Java ListResourceBundle data 

17 structure can be stored in a separate external file and loaded at run-time. 

18 

19 Figures 1-2 provide an example of how Java programmers use existing 

20 Java methodology to internationalize a Java program and then how 

21 translators, also called localizers, subsequently localize the internationalized 

22 Java program. Referring to the flow chart 10 of Figure 1, the first step, shown 

23 at Block 12, for internationalizing a Java program is to identify the localizable 
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1 areas, such as localizable strings, within the Java source code. For purposes 

2 of this example only, assume that the Java code of interest is contained in a 

3 file named "myApplication.java": 

4 /* "Display adjustment" and "Volume adjustment" are the */ 

5 /* strings that needs to be made localizable. As it appears */ 

6 /* in this manner, they cannot be translated. */ 

7 myCheckboxl = new Checkbox("Display adjustment"); 

8 myCheckbox2 = new Checkbox("Volume adjustment"); 

9 

10 It will be understood that only two strings have been shown in the example for 

Jl;;!n ease of explanation and that one skilled in the art will recognize that Java 

C,ai source code will typically have dozens or even hundreds of strings. The next 

Hi3 step, at Block 14, is to create a unique key for each of the identified localizable 

- ] i4 strings. Assume that the key for the localizable string "Display adjustment" will 
be "display_adj" and that the key for the localizable string "Volume adjustment" 

^46 will be "volume_adj". At Block 16, the next step is create a subclass of a 

yin ListResourceBundle and override its getContents() method that will contain the 

is localizable string(s). The following is some sample Java code in a file called 

19 "myResources.java": 

20 import java.util.*; 

21 public class myResources extends ListResourceBundle { 

22 public Object[][] getContents() { return contents }; 

23 static final Object[][] contents = { 

24 {"display_adj", "Display adjustment"}, 

25 {"volume_adj", "Volume adjustment"} 

26 }; 

27 }; 
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2 Then, the locale in the source code must be determined so that the correct 

3 language version of ListResourceBundle can be loaded/accessed by the Java 

4 program at run-time, as shown in Block 18. Sample Java code that will 

5 accomplish this step is shown below and will be added prior to the Java code 

6 associated with Block 12 above: 

7 /* Obtain the locale information for this application. */ 

8 /* If this Java program is running in French mode, */ 

9 /* "getDefault() M will return French. */ 
nio Locale locale; 

locale = Locale.getDefault(); 

Hl2 

ui3 /* Use the locale information (from above) to obtain the */ 

Hi4 /* locale-specific version of myResources. So, if the locale */ 

* 15 /* is set to French, the "getBundle() M will return a French */ 

r |i6 /* language version of the ListResourceBundle. */ 

l: :ifi7 public static ResourceBundle rb; 

u;li8 rb = ResourceBundle. getBundle("myResources", locale); 

20 Finally, at Block 20, the localizable string(s) are obtained from the 

21 ListResourceBundle. Sample Java code to accomplish this step in the 

22 "myApplication.java" file follows: 

23 /* Obtain the locale information for this application. 7 

24 /* If this Java program is running in French mode, */ 

25 /* "getDefault()" will return French. */ 

26 Locale locale; 

27 locale = Locale.getDefault(); 

28 
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1 /* Use the locale information (from above) to obtain the */ 

2 /* locale-specific version of myResources. So, if the locale */ 

3 /* is set to French, the ,T getBundle()" will return a French */ 

4 /* language version of the ListResourceBundle. */ 

5 public static ResourceBundle rb; 

6 rb = ResourceBundle. getBundle("myResources", locale); 

7 

8 /* Obtain the localizable strings by calling "getStringO" */ 

9 /* and by passing the key for each of the localizable strings. */ 

10 /* So, if the above calls fetched a French ListResourceBundle, */ 
n /* myResources. rb.getString("display_adj") */ 

_.i2 /* will return the French translation of the string 7 

uli3 /* "Display Adjustment" 7 

Ei4 myCheckboxl = new Checkbox(myResources.rb.getString( ,, display_adj ,, ); 

r ji5 myCheckbox2= new Checkbox(myResources.rb.getString("volume_adj H ); 

Ol6 

* 17 The Java program has thus been internationalized according to the prior 

J;;;{i8 art method of Figure 1 . Now suppose that the internationalized Java program 

J;ii9 must be translated or localized to the desired locale. This methodology is 

20 illustrated by flow chart 30 of Figure 2. The first step, at Block 32, is to obtain 

21 the ListResourceBundle for a given Java program that is to be localized. The 

22 ListResourceBundle will consist of Java code with "{key, value}" pairs. Sample 

23 Java code in the "myResources.java" file that will accomplish this step follows: 

24 import java.util.*; 

25 public class myResources extends ListResourceBundle { 

26 public Object[][] getContents() { return contents }; 

27 static final ObjectQQ contents = { 

28 {"display_adj", "Display adjustment"}, 



Attorney Docket Number: 10980065-1 6 



PATENT 



1 {"volume_adj", "Volume adjustment"} 

2 }; 

3 }; 

4 

5 The next step, at Block 34, is to translate only the "value" portion and not the 

6 "key" portion of the ListResourceBundle source code data structure, being 

7 sure not to modify anything else within the source file. The file may be 

8 renamed to indicate the translation language. For instance, the French 

9 version of the "myResources.java" file may be titled the "myResourcesJt.java" 

10 file. Sample Java code in the "myResources_fr.java" file may be as follows: 
rui import java.util.*; 

y :;!i2 public class myResources extends ListResourceBundle { 

Mi3 public Object[][] getContents() { return contents }; 

Liu static final ObjectQ[] contents = { 

gi5 {"displa^adj", "Re'glage d'affichage"}, 

* 16 {"volume_adj", "Re'glage de volume"}, 

CF }; 

L :I18 }; 

y:ii9 

20 Unfortunately, using a ListResourceBundle data structure presents 

21 several disadvantages, as can be seen from the above example. First, 

22 ListResourceBundle data structures are source code and are therefore not 

23 easily translatable. Translators cannot use any of the "localization tools" 

24 applicable for message catalogs and the difficulty becomes distinguishing 

25 display strings which need to be translated from non-display strings which do 

26 not require translation. The Java code thus has to be combed manually, i.e. 



Attorney Docket Number: 10980065-1 7 



PATENT 



1 line-by-line, to identify the display strings that need to be translated. The 

2 display strings must then be changed manually to make it translatable. 

3 Needless to say, this process is very time-consuming and inefficient. While 

4 mechanisms such as PERL script may be used to assist in this endeavor, the 

5 results must still be checked manually. 

6 

7 Second, writing Java source code that loads and accesses a 

8 ListResourceBundle data structure is cumbersome. Additionally, identifying 

9 obsolete or new or modified strings that require new translations is difficult 
yho using a ListResourceBundle data structure. Modifying the Java source code 

without translating the accompanying ListResourceBundle data structure will 

Si2 cause the Java program to throw an exception, sometimes referred to as 

s 13 "throwing an exception," similar to a core dump in a C program, for not being 

Oi4 able to find a translated string. Finally, modifying an existing non-global 

= H5 application to use ListResourceBundle data structures is difficult because the 

■ ;i i6 process of separating the display strings from the Java source code generally 

n cannot be done automatically. It is much easier to build a global program from 

is the ground up rather than attempt to retrofit an existing non-global application 

19 because of this difficulty. It is therefore difficult to modify an existing Java- 

20 based non-global application to make it capable of using ListResourceBundle 

21 data structures. 

22 
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1 SUMMARY OF THE INVENTION 

2 It is therefore an object of the present invention to provide easily 

3 translatable display strings for the Java programming language. It is another 

4 object of the present invention to provide a less cumbersome means of loading 

5 and accessing a ListResourceBundle data structure. It is yet another object of 

6 the present invention to identify obsolete or new or modified display strings 

7 that require new translations. Finally, it is an object of the present invention to 

8 provide a means of converting an existing non-global application into a global 

9 application using ListResourceBundle data structures. 
g;!io 

j^n Therefore, according to the present invention, a methodology for 

I"i2 generating localizable message catalogs for Java-based applications is 

Z 13 disclosed. Message catalogs that are automatically flagged for what needs to 

Qi4 be manually translated are generated from a given Java source code file, 

4*15 which can then be used for translation. ListResourceBundle data structures 

^16 that are compatible with Java's internationalization model are also generated 

17 from the message catalogs that were previously generated and manually 

is translated into desired local language(s). The methodology comprises: 

19 identifying one or more localizable strings of a Java source code; marking the 

20 one or more localizable strings to produce one or more marked localizable 

21 strings by inserting a marker into each localizable string of the one or more 

22 localizable strings that are function calls to an internationalization tool; 

23 extracting the one or more marked localizable strings; storing the one or more 
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1 marked localizable strings into an external text file, such as a message catalog 

2 file; and generating one or more ListResourceBundle data structures from the 

3 one or more marked localizable strings stored in the external text file. 

4 Extracting and storing the one or more marked localizable strings into one or 

5 more text files and generating the one or more ListResourceBundle data 

6 structures occurs when the Java source code is compiled. The one or more 

7 ListResourceBundle data structures are generated by: determining a current 

8 locale language in which the Java source code is running; determining 

9 whether the current locale language is a default language; if the current locale 

10 language is the default language, returning a marked localizable string of the 
n one or more marked localizable strings; if the current local language is not the 

12 default language, determining whether a language-specific version of the 

13 marked localizable string that corresponds to the current locale language 

14 exists in a ListResourceBundle data structure of the one or more 
is ListResourceBundle data structures that corresponds to the marked 

16 localizable string; and if the language-specific version exists, opening the 

17 ListResourceBundle that corresponds to the marked localizable string and 
is returning the language-specific version of the marked localizable string from 

19 the ListResourceBundle. The one or more marked localizable strings of the 

20 Java source code can be translated by: obtaining the external text file 

21 containing the one or more marked localizable strings; translating the one or 

22 more marked localizable strings stored in the external text file; and generating 

23 a ListResourceBundle data structure for the translated one or more marked 



Attorney Docket Number: 10980065-1 10 



PATENT 



localizable strings. 

After storing the marked localizable strings into the external text file, the 
methodology further comprises: generating a new version of the Java source 
code in a second directory from which an internationalization tool is run; 
retrieving the marked localizable strings from a ListResourceBundle class; and 
generating a merged external text file containing the one or more marked 
localizable strings in the first directory and the second directory. 
ListResourceBundle files corresponding to the merged external text file with 
each ListResourceBundle file of the one or more ListResourceBundle files 
corresponding to a desired language are generated. 

The above methodology is accomplished according to the following: 
opening an original Java source code file that is stored in a first directory; 
opening a first message catalog file; copying the first message catalog file to a 
second message catalog file; creating a modified Java source code file from 
the original Java source code file in a second directory; reading the contents of 
the original Java source code file into a buffer; if the buffer contains one or 
more marked localizable strings, for each marked localizable string of the one 
or more marked localizable strings comprising: obtaining a message number 
corresponding to the marked localizable string and replacing the marked 
localizable string in the buffer with a method call that can obtain the marked 
localizable string if the marked localizable string is stored in the first message 
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1 catalog file, or appending the marked localizable string to the second message 

2 catalog file and removing a marker from the marked localizable string in the 

3 buffer to convert the marked localizable string to a default localized string if the 

4 marked localizable string is not stored in the first message catalog file; writing 

5 to the modified Java source code file from the buffer; and closing the original 

6 Java source code file, the first message catalog file, the second message 

7 catalog file, and the modified Java source code file. 

8 
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1 BRIEF DESCRIPTION OF THE DRAWINGS 

2 The novel features believed characteristic of the invention are set forth 

3 in the claims. The invention itself, however, as well as the preferred mode of 

4 use, and further objects and advantages thereof, will best be understood by 

5 reference to the following detailed description of an illustrative embodiment 

6 when read in conjunction with the accompanying drawing(s), wherein: 

7 

8 Figure 1 is a flow chart for internationalizing a Java program, according 

9 to the prior art; 

Jii Figure 2 is a flow chart for translating or localizing the Java program, 

U12 according to the prior art; 

s 13 

Ou Figure 3 is a flow chart that illustrates the methodology for 

%5 internationalizing a Java program and then translating the internationalized 

% '*i6 Java program to a desired locale, according to the present invention; 

17 

is Figure 4 is a flow chart that illustrates the MsgHandler.java class, 

19 including the "getString" method, according to the present invention; 

20 

21 Figure 5 is a flow chart that illustrates the methodology for translating or 

22 localizing a Java program, according to the present invention; 

23 
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Figure 6 is a flow chart that illustrates the methodology of the present 
invention; and 

Figure 7 is a flow chart that illustrates the methodology of the present 
invention, with emphasis on identifying modified strings that require new 
translations. 
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1 DESCRIPTION OF THE INVENTION 

2 The method for generating localizable message catalogs for Java-based 

3 applications of the present invention provides a mechanism whereby a 

4 ListResourceBundle data structure file is automatically generated from an 

5 existing Java source code file using an intermediate message catalog file that 

6 may be manually translated to a local native language to provide global 

7 software that can operate under various native language environments and 

8 thus is capable of being used world-wide. This mechanism of the present 

9 invention, referred to as the internationalization tool, generates Unix-style 

10 message catalogs as intermediate files and then generates 
n ListResourceBundle data structures from those intermediate message 

12 catalogs. Without the internationalization tool, the programmer must manually 

13 create the ListResourceBundle data structures used by Java to create 
H localizable strings. When a user starts up an internationalized Java-based 

15 application, the application determines the locale in use by the user and that 

16 locale will be used by the application for the display text and other user 
n interface elements. 

18 

19 Therefore, according to the present invention, a method for generating 

20 localizable message catalogs, in which there is one message catalog file per 

21 Java package-and not per Java class-is disclosed. First, the present invention 

22 generates message catalogs automatically from a given Java source code, 

23 which can then be used for translation. Next, the present invention 
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1 automatically generates the ListResourceBundle data structures from the 

2 message catalogs that were derived and translated so that the final result is 

3 compatible with Java's internationalization model. Finally, the present 

4 invention automatically flags what needs to be translated providing a more 

5 efficient means of maintaining a language-specific version of Java-based 

6 software after it has been released. 

7 

8 Referring now to Figures 3-7, the methodology of the present invention 

9 for internationalizing a Java program and then translating the internationalized 
y'lio Java program to a desired locale is described. Referring first to the flow chart 
[ li 40 of Figure 3, the Java programmer identifies the localizable string(s) within 

Tl.x 

D2 the Java source code that make up a Java package at Block 42. These 

: 13 localizable string(s) include previously localized strings, modified strings, and 

□14 new strings. There is one message catalog per Java package, not per Java 

445 class. This step is similar to Block 12 of Figure 1 and sample Java code in file 

^16 "myApplication.java" follows: 

17 /* "Display adjustment" and "Volume adjustment" are the */ 

is /* strings that needs to be made localizable. As it appears */ 

19 /* in this manner, they cannot be translated. */ 

20 myCheckboxl = new CheckboxfDisplay adjustment"); 

21 myCheckbox2 = new Checkbox("Volume adjustment"); 
22 

23 The next step, at Block 44, is for the programmer to insert a "><" marker for 

24 each of the localizable strings. The file "myApplicationJava" is modified in this 

25 manner: 
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1 /* "Display adjustment" and "Volume adjustment" are the */ 

2 /* localizable strings. 7 

3 myCheckboxl = new Checkbox("><Display adjustment"); 

4 myCheckbox2 = new Checkbox("><Volume adjustment"); 

5 

6 The localizable display strings "Display adjustment" and "Volume adjustment" 

7 of the file "myApplication.java" are easily identified by the "><" inserted by the 

8 programmer and are taken out of the source code and stored in one or more 

9 external message catalog files for later translation. A representative source 

10 version of the message catalog file for the "myApplication.java" file is as 
^fn follows: 

[7i2 $set 1 

J i.i 

ik3 1 Display adjustment 

0 ii4 2 Volume adjustment 

l ;;fi6 It is noted that the message catalog file contains simply the localizable display 

jin string and does not contain Java source code, thereby making it easily 

is translatable. This source version of the message catalog file contains 

19 messages and is not yet compiled. 

20 

21 Next, at Block 46, an internationalization tool of the present invention 

22 modifies the Java source code to extract the identified localizable string(s), 

23 marked with "><", to one or more external, intermediate message catalog files 

24 when the Java program is compiled. Strings marked with "><" in the source 
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1 files are extracted and converted to Realizable messages in output file(s), i.e. 

2 message catalog file(s). The localized messages in the message catalog 

3 file(s) are function calls to an internationalization tool-generated function that is 

4 used as an access to ListResourceBundle data structures for Java sources. 

5 For Java programs, the internationalization tool converts the message 

6 catalogs into ListResourceBundle data structures. This activity occurs 

7 automatically when the Java program is compiled. It is transparent to the user 

8 and requires no intervention by the Java programmer. As will be described, 

9 the internationalization tool also generates the getString function. 

J41 Continuing with the given example, when the above Java program is 

R2 compiled, the internationalization tool will intervene and modify the Java 

a 13 source code file "myApplication.java" so that it becomes the following: 

£■ k Locale locale; 

];b locale = Locale.getDefault(); 

%6 public static ResourceBundle rb; 

17 rb = ResourceBundle.getBundlefmyResources", locale); 

is myCheckboxl = new Checkbox(MsgHandler.getString("1 "/Display 

19 Adjustment")); 

20 myCheckbox2 = new CheckboxCMsgHandler.getStringC^'/Volume 

21 Adjustment")); 

22 

23 The internationalization tool automatically generates a new Java class, 

24 called "MsgHandler.java", having the definition of one method or function, 

25 called the "getStringQ" method. A representative MsgHandler.java file that is 
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1 automatically generated by internationalization tool follows: 

2 import java.util.*; 

3 public class MsgHandler { 

4 public static String getString(String key, String defaultMessage) { 

5 //SECTION A of CODE 

6 if ^initialized) { 

7 Locale locale = null; 

8 //get the default locale 

9 locale = Locale. getDefault(); 
y;io 

t)i //SECTION B of CODE 

J42 String localejanguage; 

1 13 localejanguage = locale. getLanguage(); 

QL4 if (!(locale_language.equals("en"))) { 

=: 45 try { 

^% rb = ResourceBundle.getBundle("myResources", locale); 

17 } 

18 catch (Exception ex) { 

19 rb = null; 

20 } 

21 } // if 

22 else rb = null; 

23 initialized = true; 
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} 

//SECTION C of CODE 

if (rb == null) return defaultMessage; 



//SECTION D of CODE 

String str; 
try{ 

str = rb.getString(key); 
} catch (Exception ex1) { 
str - defaultMessage; 

} 

return str; 

} 

private static ResourceBundle rb; 
private static boolean initialized = false; 



This representative code of the internationalization tool automatically 
generates the MsgHandler.java class. The MsgHandler.java class consists of 
one method called "getString". The "getString" method performs various 
functional steps outlined in Sections A-D of the code and illustrated in the 
methodology of Figure 4. It is recognized that the particular source code for 
the "MsgHandler.java" file may be different from that shown above without 
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departing from the spirit and scope of the invention. 

Referring now to Figure 4, methodology 50 of the "MsgHandler.java" file 
is illustrated. At Block 52, the current locale language being used by the Java 
program must be determined. Is the program currently running in the English, 
French, or Japanese languages, for instance? Section A of the 
MsgHandler.java file above accomplishes this step. Next, at Decision Block 
54, the inquiry is whether this current language is English, the default 
language. If it is, then the default English string that was passed into the 
"getString" method is returned at Block 55; this is accomplished by Section C 
of the MsgHandler.java file. If the current language is not English, then the 
flow continues to Block 56. At Block 56, the language-specific version of the 
ListResourceBundle code is located, as illustrated by Section B of the 
MsgHandler.java file. Next, the inquiry at Decision Block 58 is whether the 
language-specific version of the ListResourceBundle code exists. If it does not 
exist, the flow goes to Block 55 to return the default English string that was 
passed into the "getString" method; this is demonstrated by Section C of the 
MsgHandler.java file code. If the language-specific version does exist, then 
the language-specific localized string from the ListResourceBundle is returned 
at Block 59, such as demonstrated by Section D of the above code. 

The automatic call performed by the "getString" method has a key 
benefit for performance. A call to open a ListResourceBundle is relatively 
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expensive in terms of the time required to make a call over a network and the 
"getString" method provides the advantage of minimizes such calls. Also, from 
Block 106 of Figure 6, one can see that the internationalization tool will not 
even call the wrapper function of "getString" if the >< string has not been 
localized. This too represents a performance improvement because in this 
case there is no need to check for the locale information and the "getString" 
method is bypassed. 

In addition to this performance advantage, another advantage that is 
realized with the "getString" method is the ease with which Java software may 
be upgraded. This is best explained with an example. Suppose that the 
internationalized Java program originally contained two localization strings, as 
in the above example. Those two strings were translated in the French 
language. When the Java program is executed, the getString method will 
attempt to retrieve the localized/translated French strings. Now, suppose that 
the Java programmer adds another "><" string to this program or even 
modifies an existing "><" string, such as: 

MyCheckboxl = new Checkbox ("xDisplay adjustment"); 

MyCheckbox2 = new Checkbox ("><Volume adjustment"); 

MyCheckbox3 = new Checkbox ("><Color adjustment"); 
It can be seen that a new string for color adjustment as been added. 

When this modified Java program is processed by the 
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internationalization tool, the new "><" string will not be replaced with the 
getString method call because the internationalization tool knows that this 
string has not yet been localized as stated in Block 102 of Figure 7. As a 
result, this modified Java program can execute under the French language 
even though this new string does not even appear in the ListResourceBundle 
associated with this French Java program, without throwing an exception. 
This allows the modified Java source code and ListResourceBundle to be 
decoupled, a condition that occurs when the ListResourceBundle data 
structure is not translated at the same time that the Java source code is 
modified without throwing an exception. 

The above model allows easier upgrade of the Java software. The 
process has effectively "de-coupled," or separated, two processes: the process 
of internationalizing the Java program via the "><" indicator, accomplished by 
Java programmers, and the process of translating the message catalogs, 
accomplished by the translators. Since these separate processes are de- 
coupled, they can occur independently. This is an important characteristic 
when localizing software to any number of different languages for release at 
the same time-rather than releasing the English version first, followed by other 
language versions of the code. If these processes were not de-coupled in this 
manner, the Java program would always have to be in sync with the localized 
version of the ListResourceBundle data structure. This requirement is 
particularly onerous in the typical situation in which there is a team of 
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1 programmers in one country and another team of translators in a different 

2 country. It is quite common that the team of translators are almost never on- 

3 site with the programmers. Moreover, the costs associated with translation 

4 may be prohibitive but, with the present invention, it is no longer necessary to 

5 always perform translation of modified or added strings at the time that the 

6 Java source code is modified. 

7 

8 Now that internationalization of the Java program has been performed, 

9 the next step is translation of the localizable strings stored in the message 
";|o catalog file. Referring now to Figure 5, flow chart 60 illustrates the 
Mi methodology of the present invention for translating the localizable string(s) 
1 12 and how the localized ListResourceBundle is generated. At Block 62, the 
% 13 message catalog file associated with the Java package of related Java source 
J44 code files is obtained. As previously mentioned, it does not contain source 
jks code, containing only the display strings, and is therefore readily translatable. 
y;|6 Next, at Block 64, the localizable display strings in the message catalog file 

n are translated. Continuing with the above-described message catalog for the 

is "myApplication.java" file, the French translated version of the message catalog 

19 is: 

20 $set 1 

21 1 Re'glage d'affichage 

22 2 Re'glage de volume 

23 

24 Following the translation, the internationalization tool will again intervene and 
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1 process the translated message catalog to automatically generate the 

2 translated version of the ListResourceBundle Java code, at Block 66. Sample 

3 Java code in file "myResources_fr.java" automatically generated by the 

4 internationalization tool would be: 

5 import java.util.*; 

6 public class myResources_fr extends ListResourceBundle { 

7 public Object[]Q getContents() { return contents }; 

8 static final ObjectQQ contents = { 

9 {"1 "Re'glage d'affichage"}, 

10 {"2", "Re'glage de volume"}, 

cti }; 

y :i2 }; 

1-13 

5;;;l4 As previously discussed, the Java programming language uses 

5 is ListResourceBundle to create localizable strings. The internationalization tool 

f 16 generates X/Open Portability Guide style message catalogs as intermediate 

J;i7 files from which ListResourceBundle may be generated. 

19 A more detailed example of the methodology of the present invention is 

20 presented in the flow diagrams of Figures 6-7. Consider for purposes of this 

21 example that the internationalization tool is referred to as "Msgs." Referring 

22 now to flow diagram 70 of Figure 6, Blocks 72-84 illustrate in greater detail the 

23 methodology of the present invention for implementing Block 46 of Figure 3. 

24 After identifying localizable strings and inserting "><" for each identified string 

25 as shown at Blocks 42 and 44 of Figure 3, the internationalization tool Msgs is 
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1 run on each of the Java class files that contain the "><" localizable strings to 

2 extract the localizable strings and generate a new version of the Java class file 

3 in a new directory as shown at Blocks 72 and 74. At Block 72, Msgs extracts 

4 the "><" strings into an intermediate message catalog, and at Block 74, Msgs 

5 generates a new version of the Java class file in the directory from which Msgs 

6 is run. Msgs is executed in the following manner: 

7 Msgs -J -c $NLS_CAT -d $ PRENL S_D I R -n $NLS_DIR -D . -K \ 

8 -p $ PACKAGE_NAME $SOURCEJDIR/$SOURCE_FILE 

9 in which -j specifies "Java mode" and -c $nls_cat specifies the name for 
%o the message catalog, -d $prenls__dir specifies the path to the pre-nls 
lii directory and this path may be a relative path; the pre-nls directory specified 
I i2 by $prenls_dir contains the original message catalog file that was translated 
y i3 before. -n $nls_jdir specifies the path to nls/C directory and this 
f 14 specification may also be a relative path, nis/c is a directory that will contain 
J;l5 a new message catalog file that is effectively the entire contents of pre- 
y 16 nis/$NLS_CAT file with all of the new and modified messages that were found 

n in the Java program. This new message catalog is called ii1s/c/$nls_cat 

is file. Once this new nis/c/$NLS_CAT file is translated, it will replace 

19 $prenls_dir/$nls_cat file, -d path specifies the destination for the output 

20 of the modified version of the Java class. The programmer should take care to 

21 not overwrite the original Java class file by specifying a different location than 

22 the original source location, -k is for the multiple message mode and must be 

23 specified, -p $package_name specifies the complete name of the Java 
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1 package to which the particular Java class belongs. $source_dir is the path 

2 to the directory that stores the localizable Java class files identified by "><". 

3 This directory should be different from the directory from which the Msgs 

4 internationalization tool is executed, i.e. the value being passed to the -d 

5 option. $source-file is the name of the Java class file containing the 

6 localizable "><" strings. The execution of Msgs by the foregoing commands 

7 generates files in the $nls_dir directory and also rewrites a modified version 

8 of the . j ava file. 

9 

""t 

y;io At Block 76, from within the same $nls_dir directory, the 

ill MsgHandler. java file is generated. MsgHandler. java file will be used by 

f=42 the Java code to retrieve the "><" localizable strings from a 

=i" 13 ListResourceBundle class. Please refer to Figure 4 and the foregoing 

Q4 discussion for a detailed description of the MsgHandler. java file. The Msgs 

e K5 internationalization tool is executed in the following way to generate the 

"16 MsgHandler . j ava file: 

17 Msgs -J -g -c $NLS_CAT -d $PRENLS_DIR -n $NLS_DIR \ 

18 -P $PACKAGE__NAME -B $ BUNDLE_NAME 

19 in which -j specifies "Java mode", -g specifies the "./MsgHandler.java" 

20 generate function, -c $nls_cat specifies the name for the message catalog 

21 described above, -d $prenls_dir specifies the path to the pre-nis directory 

22 described above, -n $nls_dir specifies the path to the nis/c directory 

23 described above, -p $package_name specifies the complete name of the 
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Java package to which this Java class belongs as described above, and -b 
$bundle_name specifies the name to be used for the ListResourceBundle 
class that Msgs will generate (for instance, »$NLS_CAT"Res). The foregoing 
code will cause Msgs to generate a new file called MsgHandier. java as 
shown at Block 76. 

Next, at Block 78, the Msgs internationalization tool generates a merged 
intermediate message catalog file. Msgs is executed in the following manner: 

Msgs -J -M -c $NLS_CAT -d $PRENLS_DIR -n . 

In which -j specifies "Java mode", -m specifies a merge mode, -c $nls_cat 
specifies the name for the message catalog (described above), -d 
$prenls_dir specifies the path to the pre-nls directory described above, and 
-n specifies the current directory. This language will cause the Msgs tool to 
generate a message catalog-like file called $nls_cat.i that contains the 
merged messages from P re-nis/$NLS_CAT. 1 and the files in the current 
directory. At Block 80, the intermediate file ii1s/c/$nls_cat. i generated by 
the Msgs tool is now available for localization, i.e. translation into another 
native language as shown at Block 64 of Figure 5. 

At Block 82, the programmer changes to the $NLS_DIR directory from 
which the Msgs tool generates a ListResourceBundle file from the intermediate 
message catalog file. As an example, MsgsP, a Perl script and not the Msgs 
executable, is executed in the following manner. 
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1 MsgsP_ $NLS_CAT.l $ BUND L E_NAM E $ PACKAGE__NAME 

2 In which $nls_cat specifies the name for the message catalog (described 

3 above), $bundle_name specifies the ListResourecBundle class name 

4 (described above), and $package_name specifies the Java package name to 

5 which this ListResourceBundie belongs. MsgsP is run for each translated 

6 (localized) version of the message catalog. For instance, if you have a 

7 Japanese version of the message catalog stored in the nis/ Japanese file, 

8 MsgsP is run on nis/japanese/$NLS_CAT. i as well. 

9 

10 Finally, at Block 84 all of the . java files are compiled, including the 

11 MsgHandler . j ava and $ BUND L E_NAM E . j ava files. 

fi3 The flow diagram 90 of Figure 7 further illustrates the methodology of 

I l i4 the present invention, with particular emphasis on identifying modified strings 

C is that require new translations. At Block 92, the original Java file is opened and 

U6 next, at Block 94, the pre-nls message catalog file is opened. At Block 95, the 

% 7 pre-nls message catalog file is copied to the nls message catalog file. A 

Sis modified Java file is created (see Step 74 of Figure 6) at Block 96. At Block 98 

19 the contents of the original Java file are read into a buffer or other temporary 

20 storage area of a computer on which internationalization tool Msgs is running. 

21 Next, at Decision Block 100, the inquiry is whether the string from the original 

22 Java file read into the buffer contains "><" to indicate that it has been 

23 previously identified as a localizable string. If yes, then the inquiry, at Block 
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1 102, is whether the "><" string exists in the pre-nls message catalog file. If no, 

2 then the string is appended to the nls version of the message catalog file, 

3 typically at the end of the message catalog file, at Block 104 and the "><" are 

4 removed in the buffer at Block 106 to leave the default English string. If yes, 

5 the message number associated with the string is obtained at Block 108 and 

6 this "><" string is replaced in the buffer with a method call to "MsgHandler- 

7 getString( )" that can obtain the localized string at Block 110. The flow 

8 continues to Block 112. 

9 

II... i 

yjo Also from Decision Block 100, if the buffer does not contain a "><" 

Hi string, the modified Java file is written from the buffer at Block 112. Decision 

Pl2 Block 112 inquires as to whether there are any more strings in the buffer. If 

g 13 the end of the file has not been reached, then the flow returns to Block 98 from 

□4 Decision Block 114. If the end of the file has been reached, however, the flow 

jls continues to Block 116. Finally, the original Java file, the pre-nls and nls 

yl i6 message catalog files, and the modified Java file are closed at Blocks 116- 

n 120. 

18 

19 An advantage of the methodology of Figure 6 is illustrated by Blocks 104 

20 and 105. When a "><" string does not already exist in the message catalog 

21 specified by $NLS_CAT and stored in $PRENLS_DIR, this indicates that the 

22 string is new or has been modified and hence it has never been localized. 

23 This new, or modified, string is appended to the bottom of the copied version 
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of the message catalog $NLS_DIR/$NLS_CAT. It is this 
$NLS_DIR/$NLS_CAT file, and not the $PRENLS_DIR/$NLS_CAT file, that is 
actually sent to the translators for translation. Because all of the new and/or 
modified strings are appended to the bottom of the file, the translators can 
easily identify which strings to translate, thereby significantly speeding up the 
translation effort. 

The present invention solves a number of problems associated with 
internationalization of Java-based software and applications. First, the present 
invention generates message catalogs automatically from a given Java source 
code, which can then be used for translation. The automatic generation of 
message catalogs from Java source code avoids having to translate 
ListResourceBundle data structures which are difficult to translate. Next, the 
present invention automatically generates the ListResourceBundle data 
structures from the compiled or processed version of the message catalogs 
that were generated and translated so that the final result is compatible with 
Java's internationalization model. Additionally, the present invention 
automatically modifies the Java source code so that it loads and accesses 
ListResourceBundle data structures, thereby overcoming the cumbersome 
prior art procedure of having to write Java code that loads and accesses 
ListResourceBundle data structures. 

The methodology of the present invention thereby provides a number of 
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advantages over the prior-art methodology. The method is transparent to the 
user and provides a greatly needed degree of flexibility and consistency in 
internationalization of Java-based software in the art. The present invention is 
also time-saving. There is no need to extract strings from the source code for 
message catalogs; this step is automatically performed by the 
internationalization tool of the invention. Moreover, the present invention is 
much faster in that a time-consuming call to open a ListResourceBundle is not 
executed if a "><" string has not been localized. This provides for faster 
execution of the Java code. Also, de-coupling the process of translating 
strings from the process of internationalizing the Java code allows for ease of 
maintaining the software. The appending of new and/or modified translatable 
strings to the end of the $NLS_DIR/$NLS_CAT file makes it easy for the 
translator to find the strings to be translated at some future time. 

While the invention has been particularly shown and described with 
reference to a preferred embodiment, it will be understood by those skilled in 
the art that various changes in form and detail may be made therein without 
departing from the spirit and scope of the invention. While only two strings 
have been discussed in the examples described above for ease of 
explanation, one skilled in the art will recognize that there are typically 
hundreds or even more localizable strings. With this great number of strings 
typically found in Java source code, it can be seen that the job of translating 
and maintaining the strings is extremely cumbersome using prior art 
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approaches. The present invention greatly improves the efficiency and ease 
with which global Java source code may be written and maintained. 
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i What is claimed is: 

2 

3 1. A method for generating localizable message catalogs for Java-based 

4 applications, comprising: 

5 

6 identifying one or more localizable strings of a Java source code; 

7 

8 marking the one or more localizable strings to produce one or more 

9 marked localizable strings by inserting a marker into each localizable string of 
y|o the one or more localizable strings; 

r fi2 extracting the one or more marked localizable strings; 

i;;i4 storing the one or more marked localizable strings into an external text 

His file; and 

'16 

n generating one or more ListResourceBundle data structures from the 

is one or more marked localizable strings stored in the external text file. 

19 

20 2. The method of claim 1, wherein extracting and storing the one or more 

21 marked localizable strings into one or more text files and generating the one or 

22 more ListResourceBundle data structures occurs when the Java source code 

23 is compiled. 
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3. The method of claim 1, wherein the external text file is a message 
catalog file. 

4. The method of claim 1, wherein the one or more marked localizable 
strings in the external text file are function calls to an internationalization tool. 

5. The method of claim 1, wherein generating one or more 
ListResourceBundle data structures from the one or more marked localizable 
strings comprises for each marked localizable string of the one or more 
marked localizable strings: 

determining a current locale language in which the Java source code is 
running; 

determining whether the current locale language is a default language; 

if the current locale language is the default language, returning a 
marked localizable string of the one or more marked localizable strings; 

if the current local language is not the default language, determining 
whether a language-specific version of the marked localizable string that 
corresponds to the current locale language exists in a ListResourceBundle 
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data structure of the one or more ListResourceBundle data structures that 
corresponds to the marked localizable string; and 

if the language-specific version exists, opening the ListResourceBundle 
that corresponds to the marked localizable string and returning the language- 
specific version of the marked localizable string from the ListResourceBundle. 

6. The method of claim 5, wherein the default language is English. 

7. The method of claim 1, further comprising translating the one or more 
marked localizable strings of the Java source code, wherein translating the 
one or more localizable strings comprises: 

obtaining the external text file containing the one or more marked 
localizable strings; 

translating the one or more marked localizable strings stored in the 
external text file; and 

generating a ListResourceBundle data structure for the translated one or 
more marked localizable strings. 
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8. A method for generating localizable message catalogs for Java-based 
applications, comprising: 

identifying one or more localizable strings of a Java source code; 

marking the one or more localizable strings to produce one or more 
marked localizable strings by inserting a marker into each localizable string of 
the one or more localizable strings; 

extracting the one or more marked localizable strings; 

storing the one or more marked localizable strings into an external text 
file in a first directory; 

generating a new version of the Java source code in a second directory 
from which an internationalization tool is run; 

retrieving the marked localizable strings from a ListResourceBundle 

class; 

generating a merged external text file containing the one or more 
marked localizable strings in the first directory and the second directory; 
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generating one or more ListResourceBundle files corresponding to the 
merged external text file with each ListResourceBundle file of the one or more 
ListResourceBundle files corresponding to a desired language; and 

compiling the one or more ListResourceBundle files and the Java 
source code. 

9. The method of claim 8, wherein the external text file is a message 
catalog file. 

10. The method of claim 8, wherein the marked localizable strings in the one 
or more intermediate message catalog files are function calls to the 
internationalization tool. 

11. The method of claim 8, wherein retrieving the marked localizable strings 
from a ListResourceBundle class comprises: 

determining a current locale language in which the Java source code is 
running; 

determining whether the current locale language is a default language; 
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if the current locale language is the default language, returning a 
marked localizable string of the one or more marked localizable strings; 

if the current local language is not the default language, determining 
whether a language-specific version of the marked localizable string that 
corresponds to the current locale language exists in a ListResourceBundle 
data structure of the one or more ListResourceBundle data structures that 
corresponds to the marked localizable string; and 

if the language-specific version exists, opening up the 
ListResourceBundle that corresponds to the marked localizable string and 
returning the language-specific version of the marked localizable string from 
the ListResourceBundle. 

12. The method of claim 1 1 , wherein the default language is English. 

13. The method of claim 8, wherein the merged external text file is an 
intermediate message catalog file. 

14. The method of claim 8, wherein after generating a merged external text 
file, further comprising: 
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translating the one or more marked localizable strings in the merged 
external text file into one or more desired languages. 

15. A method for generating localizable message catalogs for Java-based 
applications, comprising: 

opening an original Java source code file that is stored in a first 
directory; 

opening a first message catalog file; 

copying the first message catalog file to a second message catalog file; 

creating a modified Java source code file from the original Java source 
code file in a second directory; 

reading the contents of the original Java source code file into a buffer; 

if the buffer contains one or more marked localizable strings, for each 
marked localizable string of the one or more marked localizable strings 
comprising: 
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1 * 

1 determining if the marked localizable string is stored in the first 

2 message catalog file; 

3 

4 if the marked localizable string is stored in the first message 

5 catalog file, comprising: 

6 

7 obtaining a message number corresponding to the marked 

8 localizable string; and 

9 

y|o replacing the marked localizable string in the buffer with a 

hi method call that can obtain the marked localizable string; 

ri 2 

*i 3 if the marked localizable string is not stored in the first message 

Cl4 catalog file, comprising: 

^ 6 appending the marked localizable string to the second 

17 message catalog file; and 

18 

19 removing a marker from the marked localizable string in the 

20 buffer to convert the marked localizable string to a default localized string; 

21 

22 writing to the modified Java source code file from the buffer; and 

23 
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closing the original Java source code file, the first message catalog file, 
the second message catalog file, and the modified Java source code file. 

16. A method for generating localizable message catalogs for Java-based 
applications, comprising: 

generating a plurality of modified Java source code files; 

generating a message catalog file having one or more localizable strings 
for a Java package; 

translating the message catalog file manually; 

generating a plurality of ListResourceBundle data structure files for the 
one or more localizable strings of the translated message catalog file; and 

compiling the plurality of modified Java source code files and the 
plurality of ListResourceBundle data structure files. 
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ABSTRACT OF THE DISCLOSURE 

A method for generating localizable message catalogs for Java-based 
applications is disclosed. Message catalogs that are automatically flagged for 
what needs to be manually translated are generated from a given Java source 
code file, which can then be used for translation. ListResourceBundle data 
structures that are compatible with Java's internationalization model are also 
generated from the message catalogs that were previously generated and 
manually translated into desired local language(s). This provides a more 
efficient means of maintaining a language-specific version of Java software 
after if has been released. 
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made on information and belief are believed to be true; and further that these statements were made 
with the knowledge that willful false statements and the like so made are punishable by fine or 
imprisonment, or both, under Section 1001 of Title 18 of the United States Code and that such willful 
false statements may jeopardize the validity of the application or any patent issued thereon. 



Full Name of Inventor: Caroline Nan Ko ff 

Residence: 

Post Office Address: Same as residence 



Citizenship: US 



1425 Hillside Drive Ft Collins CO 80524 




Inventor's Signature 

Rev 06/99 (DecPwr) 



Date 



(Use Page Two For Additional Inventor(s) Signaturefs}) 
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1442 Silk Oak Dr Ft Collins CO 80525 



Full Name of # 2 joint inventor: William Girard McCollom 

Residence: 
Post Office Address: 



Citizenship: US 



Same as residence 




Dat 




Full Name of # 3 joint inventor: 

Residence: 

Post Office Address: 



Inventor's Signature 



Citizenship: 



Date 



Full Name of # 4 joint inventor: 

Residence: 

Post Office Address: 



Inventor's Signature 



Citizenship: 



Date 



Full Name of # 5 joint inventor: 

Residence: 

Post Office Address: 



Inventor s Signature 



Citizenship: 



Date 



Full Name of # 6 joint inventor: 

Residence: 

Post Office Address: 



Inventor's Signature 



Citizenship: 



Date 



Full Name of # 7 joint inventor: 

Residence: 

Post Office Address: 



Inventor's Signature 



Citizenship: 



Date 



Full Name of # 8 joint inventor: 

Residence: 

Post Office Address: 



Citizenship: 



inventor s signature 

Rev 06/99 (DecPwr) 



Date 



(Use Page Two For Additional lnventor(s} Signature(s)) 
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